Qt5.7文档翻译：QNetworkCookieJar类,QNetworkCookieJar Class

QNetworkCookieJar 类，实现了一个简单的 QNetworkCookie 对象容器。 详细说明……

详细说明

QNetworkCookieJar 类，实现了一个简单的 QNetworkCookie 对象容器。

小甜饼（Cookies），本质上是一小撮信息，像 HTTP 这样无状态的协议，会利用这种小撮信息来在多个请求之间维护一些持久性数据。

小甜饼，是远程服务器在向某个请求进行回复时设置的，并且，它预期着相同的小甜饼会在后续的请求中被一起发送回去。

小甜饼罐（cookie jar），即是用来储存在之前的请求中获取到的所有小甜饼的对象。网页浏览器会将它们的小甜饼罐保存到硬盘上去，以便在下次启动该程序时仍然能够保有那些持久化的小甜饼。

QNetworkCookieJar 并未实现持久化存储： 它只在内存中保存小甜饼。 一旦该 QNetworkCookieJar 对象 被删除，其中保存的所有小甜饼就都会丢失了。如果 妳想要保存这些小甜饼的话，那么，应当继承这个类，并且编写代码，以按照妳自己的格式将信息保存到硬盘上去。

这个类，只实现了小甜饼规范中建议实现的基本安全功能，并且根本 就未实现任何的 小甜饼接受策略 ( 它会接受任何一个请求中产生的所有小甜饼 ) 。 要想覆盖这些规则的话，妳应当重写 cookiesForUrl ()和 setCookiesFromUrl () 这 两个虚函数。 QNetworkReply 和 QNetworkAccessManager 会在检测到新的小甜饼以及需要读取小甜饼时调用这两个函数。

参考 QNetworkCookie 、 QNetworkAccessManager 、 QNetworkReply 、 QNetworkRequest 和 QNetworkAccessManager::setCookieJar () 。

成员函数文档

[protected] QList < QNetworkCookie > QNetworkCookieJar:: allCookies () const

返回这个小甜饼罐中保存的所有小甜饼。这个函数，适合于让继承类利用来实现以下功能：将小甜饼保存到硬盘；实现小甜饼过期策略以及其它策略。

参考 setAllCookies () 和 cookiesForUrl () 。

[virtual] QList < QNetworkCookie > QNetworkCookieJar:: cookiesForUrl (const  QUrl  & url ) const

返回那些 在向 url 发起请求时应当添加的小甜饼。 它个函数会被默认实现的 QNetworkAccessManager::createRequest ()调用，后者 会将此函数所返回的小甜饼添加到即将发送的请求中去。

如果找到了多个具有相同名字但路径不同的小甜饼，那么，路径较长的小甜饼会排在前面。换句话说，这个函数所返回的小甜饼，会按照路径的长度降序排序。

默认 的 QNetworkCookieJar 类中只实现了一个狠基本的安全策略（ 它会确保小甜饼的域名和路径与响应消息相匹配 ）。 若想以妳自己的独特算法来加强安全策略的话，那么就覆盖掉cookiesForUrl()。

参考 setCookiesFromUrl () 和 QNetworkAccessManager::setCookieJar () 。

[protected] void  QNetworkCookieJar:: setAllCookies (const  QList < QNetworkCookie > & cookieList )

将这个小甜饼罐中存储的内部小甜饼列表设置成 cookieList 。 这个函数适合于让继承类利用来实现以下功能： 从持久化存储中载入小甜饼；或者，重写 setCookiesFromUrl ()以实现自己的小甜饼接受策略。

参考 allCookies () 和 setCookiesFromUrl () 。

孟茜

严禁开窗

开窗击毙

王艳

未知美人